docs: add standalone Contributor License Agreement page (refs #12863)#13225
Open
AshrafHosam wants to merge 3 commits intoEbookFoundation:mainfrom
Open
docs: add standalone Contributor License Agreement page (refs #12863)#13225AshrafHosam wants to merge 3 commits intoEbookFoundation:mainfrom
AshrafHosam wants to merge 3 commits intoEbookFoundation:mainfrom
Conversation
…undation#12863) Issue EbookFoundation#12863 reports that the Contributor License Agreement is rendered within docs/CONTRIBUTING along with unrelated content, making it hard to read in isolation. The repository did not previously expose a dedicated CLA page. Add docs/CONTRIBUTOR_LICENSE_AGREEMENT.md containing only the CLA text (rights, representations, license grant), include it in _config.yml, and link to it from the CLA section of CONTRIBUTING. Users who want to read only the CLA now have a clean, focused page.
Jekyll processes docs/ by default; the include list only matters for root-level files that would otherwise be excluded. Drops the extra artifact that was flaking the check-urls workflow.
Collaborator
|
We'll need more info on the observed issue - I cant reproduce it |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
Improve repo / Add standalone documentation page
Description
Refs #12863.
The reporter of #12863 expected a Contributor License Agreement page that displays only its own content. In the current repo, the CLA is a short section inside
docs/CONTRIBUTING.md, so users who follow a CLA link land on the larger Contributing page and see unrelated content above it — which is what prompted the confusion in #12863.This PR adds a dedicated CLA page so anyone can read the agreement in isolation:
docs/CONTRIBUTOR_LICENSE_AGREEMENT.md— Jekyll frontmatter + only CLA text (rights, representations, license grant).docs/CONTRIBUTING.md— the existing CLA section now links to the new page for the full text._config.yml— addCONTRIBUTOR_LICENSE_AGREEMENT.mdto the included files list so Jekyll builds it.No existing content is removed; the change is purely additive.
Why is this valuable?
Gives the CLA a clean, focused URL (
docs/CONTRIBUTOR_LICENSE_AGREEMENT) without surrounding contributor-workflow material, addressing the core concern in #12863 ("The Contributor License Agreement page should display only its own content").Checklist: